Function            EMSinfo - determines EMM version and EMS pages

  Syntax              boolean EMSinfo(struct EMSrecord *ems);

  Prototype in        ibm.h

  Remarks             if EMS is available, EMSinfo() determines the EMM
                      version number and the total and available pages.
                      This information is saved in the ems structure
                      passed to EMSinfo().

                      This function is similar to isEMSavail() and
                      EMSpages()

  Return value        returns TRUE if EMS is available and no errors were
                      encountered. On an error, FALSE is returned and
                      ems->emserror will contain the error code.

  Note                this function is available under EMM 3.2 specs.

  See also            ibm.h
                      EMMversion(), EMSGetStatus(), isEMSavail(),
                      EMSpages(), EMSwarmbootprep()

  Example             #include <ibm.h>

                      main()
                      {
                           struct EMSrecord ems;

                           if (EMSinfo(&ems)) {
                                printf("EMM version id: %X\n",
                                       ems.version);
                                printf("Total pages: %u\n",
                                       ems.totalpages);
                                printf("Avail pages: %u\n",
                                       ems.availpages);
                           } else                   /* error */
                                printf("EMM error code %X\n",
                                       ems.emserror);
                      }